Jax4th for the Commodore Amiga Copyright 1991, 1993, 1994 Jack J. Woehr jax@well.sf.ca.us jax@cygnus.com SYSOP RCFB (303) 278-0364 ----------------------------------------------------------------------- This is free software and can be modified and redistributed under certain conditions described in the file COPYING.TXT. The Disclaimer of Warranty and License for this free software are also contained in the file COPYING.TXT. This is Jax's free ANS Forth for the Commodore Amiga. For more information on ANS Forth, contact the X3J14 Technical Committee via email at ansforth-request@minerva.com or contact the American National Standards Institute 11 W. 42nd Street New York NY 10036 The source and documentation were prepared using Amiga MicroEmacs. Listing of archive: 'JX4A0317.LZH' Original Packed Ratio Date Time Type CRC Name -------- ------ --- -------- -------- ----- ---- ------------ 15230 6277 59% 05-17-94 13:22:26 -lh1- 38BF COPYING.TXT 1827 853 54% 05-17-94 13:22:14 -lh1- 58F4 DEFIMAGE.A 131280 2953 98% 05-17-94 13:22:24 -lh1- 50CB DEFIMAGE.JX4 52 43 18% 05-17-94 13:22:12 -lh1- B73C DEFIMAGE.LNK 94 74 22% 05-17-94 13:22:12 -lh1- DD3A DEFIMAGE.MAKE 92 62 33% 05-17-94 13:22:12 -lh1- 3BA8 DEFIMAGE.WITH 37188 18371 51% 05-17-94 13:22:16 -lh1- 1E16 JAX4TH 193700 60208 69% 05-17-94 13:22:10 -lh1- 88D9 JAX4TH.A 14329 5648 61% 05-17-94 13:22:00 -lh1- 90A1 JAX4TH.I 43 37 14% 05-17-94 13:21:58 -lh1- 3AE9 JAX4TH.LNK 168 113 33% 05-17-94 13:21:58 -lh1- 30C8 JAX4TH.MAKE 65 51 22% 05-17-94 13:22:00 -lh1- AE5D JAX4TH.WITH 26 24 8% 05-17-94 13:21:58 -lh1- B96C MAKEALL 5237 1936 64% 05-17-94 13:22:32 -lh1- 9734 demo/DEMO.F 436 318 28% 05-17-94 13:22:30 -lh1- 5D7F doc/JAX4TH.BUGS 33704 14149 59% 05-17-94 13:22:28 -lh1- 2DDD doc/JAX4TH.DOC 2462 1094 56% 05-17-94 13:22:28 -lh1- 7B80 doc/JAX4TH.INTERNALS 19267 7664 61% 05-17-94 13:22:30 -lh1- 3327 doc/JAX4TH.WORDS 6684 3202 53% 05-17-94 13:43:06 -lh1- EEA1 READ_1ST.TXT -------- ------ --- 461884 123077 74% 19 file(s) Operation successful Files in this distribution -------------------------- DEFIMAGE.A C.A.P.E. source code for the default local image of JAX4TH. DEFIMAGE.JX4 The default local image to be loaded by JAX4TH in the case of the latter's being invoked from a command line interface without an image file argument. In later versions, double-clicking .JX4.info will invoke JAX4TH on the given image. DEFIMAGE.LNK Link commands for linking DEFIMAGE.JX4. DEFIMAGE.MAKE Amiga script file to make DEFIMAGE.JX4. DEFIMAGE.WITH A "with" file for the linking process. DISTRIB.TXT This description of the current distribution and restrictions (if any) on re-distribution by the user. JAX4TH Relocatable re-entrant dpANS-2-compliant Forth kernel suitable for PURE bit protection under AmigaDOS. JAX4TH.A C.A.P.E. source code for the re-entrant kernel JAX4TH. JAX4TH.BUGS Some bugs from the known bug list. JAX4TH.I Includes, macros for JAX4TH.A and DEFIMAGE.A. JAX4TH.DOC An informational file which assumes 1) that the reader has systems programmer familiarity with the Commodore Amiga 500/1000/200, and 2) that the reader is familiar with Forth, and with the particulars of the draft proposed ANS Forth promulgated by the ANS X3/X3J14 Technical Committee for an American National Standard Forth. JAX4TH.LNK Linker command file for JAX4TH. JAX4TH.MAKE Amiga script file to make JAX4TH. JAX4TH.WITH A "with" file for the linking process. JAX4TH.WORDS This is a listing with stack diagrams of the words in the FORTH-WORDLIST and a listing with stack diagrams and explanations of the words in the IMPLEMENTOR-WORDLIST. Also ... COPYING.TXT The GNU Public License. READ_1ST.TXT This file. Quickstart Instructions ----------------------- 1) Make a logical device (e.g., via AmigaDOS ASSIGN) name JX4: 2) Copy JAX4TH and DEFIMAGE.JX4 to JX4: 3) Optionally, at the AmigaDOS prompt type RESIDENT JX4:JAX4TH to make JAX4TH resident 4) From a NEWCON: (NewShell) window, type JAX4TH to launch an instance of JAX4TH. You can launch as many instances from as many NewShell windows as you like. Type INSTANCES in JAX4TH and it will return on the stack the number of instances of JAX4TH currently running. DO NOT "RUN" JAX4TH. 5) BYE exits the current instance of JAX4TH and decrements INSTANCES but does not clean up any resources allocated by the programmer: open files, allocations via the MEMORY wordlist words, resources allocated via direct CALLs to the Amiga operating system, etc. must be cleaned up by the program. BUGS ------ See JAX4TH.BUGS THANX ----- - To Steven Sarns, President of Vesta Technology, for his support of X3J14 and my attendance thereto. - To Steven R. Wheeler for moral support, clever suggestions, and debugging assistance. - To all the members of X3J14 and to chair E. Rather, to vice-chair Andy Kobziar, and to TSC chair G. Bailey. - To Wil Baden, Forth Algorithmist Emeritus. - To Peter Appelman, a friend. - To the members of the Forth Interest Group, who taught me Forth and gave me a new career. - To Darren & BJ of AMIGA PRO/AM on GEnie, who in 1989 asked me the $64,000 question, "A Forth load library? Why? Why not just write a PURE RESIDENT-able Forth?" - To Wes Howe and to Innovatronics for C.A.P.E. - and lastest and mostest, To my wife and children, who accept that Dad stays up late a lot in the basement. << END of DISTRIB.TXT >> Release notes: 0.dpANS-6.3.16 - dpANS-6 compliance. Fixed bug which prevented control structures from spanning lines in INCLUDED files. 0.dpANS-2.3.11 - fixed bug in system calls to Amiga OS. 0.dpANS-2.3.10 - Fixed some minor bugs. 0.dpANS-2.3.08 - Added SAVE-IMAGE and AUTOSTART to effect saving custom images for later reload and autostart. 0.dpANS-2.3.06 - Added command-line loading of custom image file. Minor bug fixes. 0.dpANS-2.3.04 - S" now complies with the description in the FILE wordlist, i.e., it works interpretively at not just as a compilation tool. 0.dpANS-2.3.03 - J fixed, wouldn't work inside branch constructs. 0.dpANS-2.3.02 - I fixed, wouldn't work inside branch constructs. - M* was accidentally non-findable, now findable. 0.dpANS-2.3.01 - CALL to Amiga OS now supported, see JAX4TH.DOC and JAX4TH.WORDS. 91-09-07. 0.dpANS-2.2.28 - First public release 91-09-01. BUG REPORTS AND SUGGESTED IMPROVEMENTS TO: Jax PO Box 51 Golden, CO 80402-0051 jax@cygnus.com <<== preferred jax@well.sf.ca.us 72203.1320@compuserve.com